---
title: HtmlConverter
summary: API reference for HtmlConverter.
status: draft
owner: SAIF Doc Gen
last_reviewed: 2026-09-17
library: PdfAPI.SyncFusionCore
reference_type: package
---

# HtmlConverter

`HtmlConverter` is the [BaseConverter](../PdfAPI.Core.Convert/BaseConverter.md) subclass selected by `ConverterFactory` for `.html` source files. It renders markup to PDF using Syncfusion's IE-based HTML rendering engine, always with an empty base URL, which means the source markup cannot resolve relative links to external resources such as images or stylesheets.

## Purpose
- Convert HTML markup to PDF via the Syncfusion IE-based HTML converter
  ([BR-SFC-003](../../business-rules.md#br-sfc-003-extension-to-converter-mapping), [BR-SFC-022](../../business-rules.md#br-sfc-022-html-rendered-with-ie-engine)).
- Identify itself to `ConverterFactory` and downstream consumers as the `Html` conversion type.

## Context
- Namespace: `PdfAPI.SyncFusionCore`
- Assembly/package: `PdfAPI.SyncFusionCore` (`Pdf.Local.Client` NuGet package)

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| HtmlConverter | `HtmlConverter()` | Creates a ready-to-use `HtmlConverter` instance for `ConverterFactory` to invoke against HTML source documents (`.html`); the constructor body is empty*, so no state is established beyond the base type's fields. |
| ConversionType | `override SourceConversionType ConversionType { get; }` | Returns `SourceConversionType.Html`, identifying this converter's source format to `ConverterFactory` and to the assembled `PdfResult`. |

## Inherited public members

Members in this section are inherited from `BaseConverter` in `PdfAPI.SyncFusionCore`. They are available on this type through inheritance.

| Member | Signature | Purpose | Origin |
| --- | --- | --- | --- |
| Convert | `PdfResult Convert(Stream stream, ConvertRequest request)` | Executes the full conversion: times the operation, invokes `ConfigureConverter` and `ConvertItem`, and assembles a `PdfResult` with `Status`, `Elapsed`, and `PdfProcessorType = Syncfusion`; captures rather than propagates conversion exceptions ([BR-SFC-006](../../business-rules.md#br-sfc-006-result-stamped-syncfusion-processor), [BR-SFC-010](../../business-rules.md#br-sfc-010-conversion-exceptions-captured-not-rethrown)). | `PdfAPI.SyncFusionCore` — `BaseConverter` |

## Behavioral notes
- The empty base URL used for rendering means relative-path references in the source HTML (e.g.
  `<img src="./logo.png">`) will not resolve, and such resources will not appear in the output PDF ([BR-SFC-023](../../business-rules.md#br-sfc-023-html-converted-with-empty-base-url)).
- Rendering fidelity is bounded by the Syncfusion IE engine's HTML/CSS support rather than a modern
  browser engine.
- A conversion failure is captured by the inherited `Convert` method and reported through the
  result rather than thrown ([BR-SFC-010](../../business-rules.md#br-sfc-010-conversion-exceptions-captured-not-rethrown)).

## Constraints and usage notes
- Not intended to be constructed directly by application code; `ConverterFactory` constructs and
  invokes it based on the source file extension.

## Related documentation
- [API reference](../index.md)
- [Operations and processes](../../operations-processes.md)
- [Business rules](../../business-rules.md)

> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts.

## Sources
- `PdfApi.SyncFusionCore\Convert\HtmlConverter.cs`